Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Reporting Information to the User

GXAlertTheUser

You can use the GXAlertTheUser function to display a printing alert box to the user.

OSErr GXAlertTheUser (gxStatusRecord *status);

status

A status structure of type gxStatusRecord.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXAlertTheUser function displays status information to the user in a printing alert box. The information to be displayed is described in the status parameter. The user must explicitly dismiss the printing alert box, and you must monitor the user's actions while the alert box is displayed.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find examples of using the GXAlertTheUser function in Listing 3-15 on page 3-42 and in Listing 3-16 on page 3-44 in the chapter "Printer Drivers."

A description of how to use the GXAlertTheUser function, including an example from the ImageWriter II driver, is found in the section "Displaying Status Information and the Printing Alert Boxes" beginning on page 3-41 in the chapter "Printer Drivers."

The gxStatusRecord structure is described in the section "The Status Structure" beginning on page 4-39 in the chapter "Printing Messages."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help